• Глава 17. Управление файлами и каталогами
• Тег <CFFILE>
  • Примеры управления файлами
• Тег <CFDIRECTORY>
  • Примеры управления каталогами
• Резюме

Глава 17

Управление файлами и каталогами

При использовании любой операционной системы (ОС) вы, так или иначе, пользуетесь реализуемой с ее помощью возможностью организации хранения информации на вашем устройстве. Способы хранения могут быть различными, но смысл при этом не меняется — всегда существует файловая система.

В этой связи любая файловая система предполагает управление находящимися в этой системе файлами и каталогами. В ColdFusion существуют теги <CFFILE> и <CFDIRECTORY>, позволяющие управлять файловой системой на сервере. Причем тег <CFFILE> предназначен для выполнения определенных действий над файлами, а тег <CFDIRECTORY> в свою очередь можно использовать для управления каталогами. В этой главе будут подробно описаны возможные действия, совершаемые с помощью указанных тегов.

Тег <CFFILE>

Синтаксис тега <CFFILE> зависит от того действия, определяемого по отношению к файлу с помощью атрибута ACTION, который может принимать следующие значения:

• Upload — загрузка;
  
• Move — перемещение;
  
• Rename — переименование;
  
• Сору — копирование;
  
• Delete — удаление;
  
• Read — чтение;
  
• ReadBinary — чтение бинарных файлов;
  
• Write — запись;
  
• Append — добавление.
  

Например, для действия загрузки файла синтаксис тега выглядит так:

<CFFILE ACTION = "Upload"

FILEFIELD = "formfield"

DESTINATION = "full_path_name"

NAMECONFLICT = "Error | Skip | Overwrite | MakeUnique"

ACCEPT = "mime_type/file_type"

MODE = "permission"

ATTRIBUTES = "file_attributes">

Далее приведем таблицу возможных атрибутов в зависимости от используемого действия без учета уже описанного значения upload (табл. 17.1).

Таблица 17.1. Список возможных атрибутов для разных действий тега <CFFILE>

В табл. 17.2 представлено описание атрибутов тега <CFFILE>.

Таблица 17.2. Описание атрибутов тега <CFFILE>

Следует отметить, что при действии загрузки файла (upload) с использованием тега <CFFILE> создается объект cffiie, обеспечивающий доступ к вспомогательной информации с помощью следующих переменных:

• cffiie.attemptedServerFiie — имя указанного файла, принимает значение, если в качестве атрибута DESTINATION указано полное имя файла загрузки;
  
• cffile.clientDirectory - изначальное месторасположение загружаемого файла;
  
• cffile.clientFiie — имя загружаемого файла, со стороны клиента;
  
• cffile.clientFiieExt — расширение файла, загружаемого со стороны клиента;
  
• cffile.clientFileName — имя файла без расширения, загружаемого со стороны клиента;
  
• cffile.contentsubType — содержание типа сохраненного файла; П cffile.contentType — содержание типа MIME сохраненного файла;
  
• cffile.dateLastAccessed — дата загрузки файла во время последнего обращения;
  
• cffile. fileExisted — определяет наличие файла по указанному пути и принимает значения Yes или NO;
  
• cffile. filesize — размер загружаемого файла;
  
• cffile.fiieWasAppended — указывает, добавляется ли загружаемый файл в конец существующего, и принимает значения Yes или NO;
  
• cffile.fileWasOverwritten — указывает, перезаписывается ли загружаемый файл поверх уже существующего, и принимает значения Yes или NO;
  
• cffile.filewasRenamed — указывает, переименовывается ли загружаемый файл в связи с ситуацией, когда файл уже существует, и принимает значения Yes или NO;
  
• cffile.filewassaved — указывает, сохраняется ли загружаемый файл, и принимает значения Yes или NO;
  
• cffile.oldFileSize — указывает размер файла, который был переписан, если таковой существует;
  
• cffile.serverDirectory — каталог на сервере, куда был сохранен загружаемый файл;
  
• cffile.serverFiie — имя загружаемого файла, сохраненного на сервере;
  
• cffile.serverFiieExt — расширение загружаемого файла, сохраненного на сервере;
  
• cffile.serverFileName — имя загружаемого файла без расширения, сохраненного на сервере;
  
• cffile.timecreated — дата и время создания загружаемого файла;
  
• cffile.timeLastModifled — дата и время последней модификации загружаемого файла.
  

Примеры управления файлами

Для понимания описанного выше синтаксиса тега, предназначенного для работы с файлами, приведем несколько примеров. Следующий пример позволяет нам записать определенный текст в указанный файл:

<CFFILE ACTION = "Write"

FILE = "C:\Apache\htdocs\my-app\city.htm"

OUTPUT = "<html><body><hl>NewYork</hl>">

Причем, если указанный файл не существует, то ColdFusion создает его в соответствии с определяемым месторасположением. Как видно из приведенного примера, в файле city.htm не были закрыты основные теги. Чтобы исправить данную ошибку, представим другой пример, позволяющий добавлять необходимый фрагмент текста:

<CFFILE ACTION = "Append"

FILE = "C:\Apache\htdocs\my-app\city.htm" OUTPUT = "</body></html>">

Еще один пример, приведенный ниже, предполагает копирование существующего файла по указанному пути с атрибутом "только для чтения":

<CFFILE ACTION = "Copy"

SOURCE = "C:\Apache\htdocs\my-app\city.htm"

DESTINATION = "C:\InetPub\wwwroot\my-app\"

ATTRIBUTES = "ReadOnly">

где в качестве атрибута DESTINATION может быть указано полное имя файла. Для удаления файла можно использовать следующий вариант:

<CFFILE ACTION = "Delete"

FILE = "С:\Apache\htdocs\my-app\city.htm">

Представим пример для загрузки файлов с предварительно открывающейся диалоговой формой, позволяющей выбрать необходимый файл (листинг 17.1)

Листинг 17.1. Код страницы TestUpLoadFile.cfm

<HTML> <HEAD>

<TITLE>Upload</TITLE> </HEAD> <BODY>

<h3>Upload File</h3>

<CFIF isDefined("Form.FiletoUpload")>

<CFFILE ACTION = "Upload"

DESTINATION = "C:\InetPub\wwwroot\my-app\"

NAMECONFLICT = "Overwrite"

FILEFIELD = "Form.FiletoUpload"> <CFOUTPUT>

The information about upload a file<br>

Name: #cffile.serverFile#<br> Sourse:

#cffile.clientDirectory#<br> Size: #file.fileSize#<br>

Last Modified:

#cffile.timeLastModified#<br> </CFOUTPUT> <CFELSE>

<FORM action="TestUpLoadFile.cfm"

enctype="multipart/form-data" method="post"> File for UpLoad:

<input type="file" name="FiletoUpload" size="30"><br>

<input type="submit" value="UpLoad"> </FORM> </CFIF>

</BODY> </HTML>

Здесь с помощью встроенных переменных при загрузке выбранного файла пользователю предоставляется информация об этом файле, в частности, имя файла (cffile. serverFile), исходное месторасположение загружаемого файла (cffile.clientDirectory), размер (cffiie.fiiesize) и дата и время последней модификации (cffile.timeLastModified).

Тег <CFDIRECTORY>

Как уже было отмечено, тег <CFDIRECTORY> позволяет управлять каталогами на сервере. Данный тег, так же, как и тег <CFFILE>, имеет атрибут ACTION, который может принимать следующие значения:

• List — список (по умолчанию);
  
• Create — создать;
  
• Delete — удалить;
  
• Rename — переименовать.
  

<CFDIRECTORY ACTION = "List | Create | Delete | Rename"

DIRECTORY = "directory name" NAME = "query name"

FILTER = "list filter" MODE = "permission"

SORT = "sort specification" NEWDIRECTORY = "new directory name">

В табл. 17.3 представлено описание атрибутов тега <CFDIRECTORY>.

Таблица 17.3. Описание атрибутов тега <CFDIRECTORY>

Здесь с помощью встроенных переменных при загрузке выбранного файла пользователю предоставляется информация об этом файле, в частности, имя файла (cffile.serverFile), исходное месторасположение загружаемого файла (cffile.clientDirectory), размер (cffile.fiiesize) и дата и время последней модификации (cffile.timeLastModified).

Отметим, что при действии получения списка (List) тега <CFDIRECTORY> создается объект запроса, обеспечивающий доступ к вспомогательной информации с помощью следующих переменных:

• queryName.Name — имя каталога или файла;
  
• queryName.size — размер файла;
  
• queryName.Type — тип, принимающий значение Dir или File;
  
• queryName.DateLastModified — дата и время последней модификации;
  
• queryName.Attributes — атрибуты файла;
  
• queryName.Mode — доступ, в Windows игнорируется.
  

Примеры управления каталогами

И опять же несколько примеров. Для создания нового каталога достаточно выполнить код:

<CFDIRECTORY ACTION = "Create"

DIRECTORY = "С:\Apache\htdocs\my-app\gif">

Переименовать только что созданный каталог можно следующим образом:

<CFDIRECTORY ACTION = "Rename"

DIRECTORY = "C:\Apache\htdocs\my-app\gif" NEWDIRECTORY = "С:\Apache\htdocs\my-app\jpg">

Соответственно, для удаления каталога можно воспользоваться конструкцией:

<CFDIRECTORY ACTION = "Delete"

DIRECTORY = "С:\Apache\htdocs\my-app\jpg">

И в завершение представим пример, позволяющий выводить список каталогов и файлов в соответствии с установленным текущим каталогом:

<CFDIRECTORY ACTION = "List"

DIRECTORY = "C:\Apache\htdocs\my-app\"

NAME = "QueryDir"

FILTER = "of*.*"

SORT = "datelastmodified DESC, name ASC, size DESC">

<TABLE cellpadding="0" cellspacing="0"> <TR>

<TD><b>Name</b></TD>

<TD><b>Size</b></TD>

<TD><b>DateLastModified</b></TD> </TR>

<CFOUTPUT QUERY="QueryDir"> <TR>

<TD>#Namet</TDV

<TD>#Size#</TD>

<TD>#DateLastModified#</TD> </TR>

</CFOUTPUT> </TABLE>

Здесь для вывода результатов списка каталогов и файлов был использован тег <CFOUTPUT> с атрибутом QUERY. В этом же примере были указаны атрибуты FILTER и SORT, позволяющие ограничивать и сортировать полученный список.

В качестве закрепления материала предлагаем читателю разработать собственную службу управления файловой системой, где бы можно было с легкостью обрабатывать файлы и каталоги, находящиеся на вашем компьютере, используя при этом возможности ColdFusion.

Резюме

Подведем итог. В данной главе мы использовали CFML-теги <CFFILE> и <CFDIRECTORY>.